5.3.1 提款反向验签
#简要描述: 在用户发起提款请求时,商户平台会生成一份签名数据(如交易订单),发送至后台 处理。为了确保数据未被篡改、请求来源合法可信,后台需对请求内容进行“反向验签”操作。
反向验签设置:商户需登陆商户后台自行设置 (登陆信息请向运营人员获取)如下图:
步骤说明
1、商户登陆后台
2、点击导航栏里商户管理
3、点击商户设置
4、点击开启 API 开关,输入自定义请求 url 和密钥,保存即可
请求说明
- 请求方式: POST
- 请求接口: 商户提供
- 请求媒体类型( JSON 数据格式 )Content-Type: application/json
注: 若商户未开启 API 安全,则无需处理此业务。(必看)
请求参数
参数名称 | 类型 | 必填 | 参数含义 | 参数说明 |
---|---|---|---|---|
key | string | 是 | 商户 key | 平台分配商户 key |
localOrderId | string | 是 | 商户平台本地订单号 | 商户平台本地生成唯一订单号 |
localUserId | string | 否 | 商户平台本地用户 ID | 商户平台本地用户 ID |
amount | number | 是 | 订单金额 | 提款金额 |
network | string | 是 | 主网 | 主网(目前仅支持 TRON、BSC、POLYGON、ETHEREUM) |
address | string | 是 | 提款地址 | 提款地址 |
notifyUrl | string | 否 | 回调地址 | 下单成功后,由 API 回调通知商户的地址 | (回调详情参照文档 3) |
nonce | string | 是 | 随机字符串 | 随机字符串 |
currency | string | 是 | 币种 | 币种(钱包支持数字币种) |
successRedirectUrl | string | 否 | 地址 | 成功后自动跳转地址 |
isBlockchain | boolean | 否 | 是否返回区块链信息(默认 false) | 当为 true 时,回调请求会携带订单链上交易信息 |
请求 json 样例
{
"amount": 30,
"isBlockchain": true,
"address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
"merchantId": 303675535978,
"notifyUrl": "http://conan.test/notify",
"currency": "USDT",
"localOrderId": "CONAN-9999",
"merchantCurrency": "USDT",
"nonce": "MapDwK",
"key": "dNNTJZpgFVWlYrVv",
"network": "TRON"
}
注: 系统请求(商户反向验签路径)参数是与商户提款请求参数是一致的。(必看)
响应示例
"2b703624f24962f5a12d5d1f7569447a"
响应结果说明: 响应加密后的字符串,即把请求参数与商户自定义的反向验签密钥,进行加密处理生成的加密字符串(加密算法请参考 2 如何签名)。(必看)